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Syntax 
Operators 
Symbols include: A-Z, a-z, 0-9, 7?! _ 
Operators are listed in precedence order, from highest to (many implementations add @#$¢. ) 
lowest. Operators from the same grouping are evaluated ; (semi-colon) Statement separator 
left to right. F . 
, (comma) Continues a line 
\1 Logical NOT (as a prefix) el Encloses comments 
+ Indicates a positive number (as a prefix) ( ) Enclose function arguments, 
- Indicates a negative (as a prefix) or groups for precedence 
symbol = expression ; Assignment of value to variable 
+ Raise to a whole number power stem.tail Compound variable (tail may be multiple 
simple symbols separated by periods) 
* Multiply stem.index Simulating arrays with compound variables 
/ Divide ‘abc’ or “abc” Character string notation 
% Integer divide (return integer part) "OC’X or “Oc’x Hexadecimal notation 
Il Remainder divide (return remainder) '0101’b or “0101"B _ Binary string notation 
+ Add 
- Subtract 
|| (abuttal) | Concatenate (with no space) Exceptions 
(blank) Concatenate with blank in-between 
== Strictly equal NOVALUE Reference to an unitialized variable 
a== \== Not strictly equal ERROR Command to external environment indicates error 
>> Strictly greater than FAILURE Command to external environment failed 
<<c Strictly lesser than HALT External interrupt to the script (such as a Ctrl+C) 
>>= 1<< \<< Strictly greater than or equal to NOTREADY Unready I/O device 
(strictly not less than) SYNTAX Syntax or runtime error in the script 
<<= 1>> \>> Strictly less than or equal to LOSTDIGITS Arithmetic operation lost digit(s) 
(strictly not greater than) 
= Equal to (also used for assignment) 
a \|= Not equal to 
<> >< Flow of Control 
> Greater than 
< Less than 
>= 1< \< Greater than or equal to IF-THEN IF-THEN-ELSE SIGNAL 
(not less than) SELECT CALL LEAVE 
<= 12> \> Less than or equal to RETURN EXIT ITERATE 
(not greater than) DO-END group DO-WHILE 
DO n times DO-UNTIL 
& And (both are true) DO initialize-loop-counter TO limit BY increment 
| Or (either is true) 
&& Exclusive Or (either but not both are true) 
Help 
Notes: not all implementations support all notations : 
(for example: 7 ). You can always ensure a higher Forum: https://groups.io/g/rexxla-members 
precedence for a clause by enclosing it in : 
parentheses: ( ). Websites: www.RexxlInfo.org www.RexxLA.org 


Instructions 


=(assignment) | symbol = expression ; 


ADDRESS | environment [ command ] [redirection] | 
| [VALUE ] expression [redirection] | 


redirection is: WITH INPUT _ input_redirection 

and/or: WITH OUTPUT output_redirection 

and/or: WITH ERROR _ output_rediection 
input_redirection is: [NORMAL | STREAM | STEM] symbol 


output_redirection is: [APPEND | REPLACE ] 
plus a destination: [NORMAL| STREAM | STEM] symbol 


ARG [template ] — see HINTS for [template] 
| name [expression ] [, [ expression ]]... | 
CALL | ON condition [NAME trapname ] 
| OFF condition | 
DO [repetitor ] [ condition ] 
[ instruction_list ] 
END [symbol ] 
repetitor is either: symbol = expression_i [ TO expression_t ] 
[ BY expression_b ] [ FOR expression _f ] 
or: expression_r 
or: FOREVER 


condition is either: WHILE expression_w 
UNTIL expression_u 


DROP symbol [symbol ... ] 
EXIT [ expression ] 
IF expression [;] THEN [;] instruction [ ELSE [;] instruction ] 
INTERPRET expression 
ITERATE [symbol ] 
LEAVE [symbol ] 
NOP 
NUMERIC DIGITS [ expression ] 
FORM [ SCIENTIFIC | ENGINEERING | 
[ VALUE ] expression ] 
FUZZ [expression ] 
OPTIONS expression 
PARSE [UPPER] type [template] — see HINTS for [template] 
type is: [ ARG | LINEIN | PULL | SOURCE | VERSION ] 
or: VALUE [expression] WITH 
or: VAR symbol 


PROCEDURE [ EXPOSE variable_list ] 


PULL [ template ] — see HINTS for [template] 


PUSH [ expression ] 
QUEUE |[ expression ] 
RETURN [ expression ] 
SAY [ expression ] 


SELECT ; when_part [when_part...] [ OTHERWISE [5] 
[ instruction_list...] ] END ; 


when_part is: WHEN expression [;] THEN [;] instruction 


| label_name | 
SIGNAL __ | [ VALUE ] expression | 

| ON condition [NAME trapname ] | 

| OFF condition | 


TRACE trace_setting | [VALUE] expression 
A-All 
C-- Commands 
E-- Errors 
F-- Failure 
l-- Intermediates 


?-- Toggles interactive trace On or Off 

( ? can be followed by a letter from the above list) 
+n -- Skips number of pauses specified by whole number 
-n— Inhibits trace for number of clauses specified 


Hints 


Character I/O — CHARS( [name] [,option] ) 
CHARIN( [name] [,[start] [length] ) 
CHAROUT( [name] [,[string] [start] ) 
Line I/O — LINES( [name] [,option] ) 
LINEIN( [name] [,[line] [,count]] ) 
LINEOUT( [name] [,[string] [,line]] ) 
Conversational PULL [template] 
VO-— PARSE PULL [template] 
SAY [expression] 


Concatenation— apple='-Apple' 


say 'Candy'apple outputs: Candy-Apple 
say 'Candy' apple Candy -Apple 
say 'Candy' || apple Candy-Apple 
say ‘Candy’ apple Candy -Apple 


Parsing for the ARG, PARSE, and PULL [template] — 
by Words (strings separated by blanks or spaces) 
by Delimiters (delimiters identify input data elements) 
by Numbers (for starting or relative column positions) 
— Periods can be used to skip or exclude data elements 
Examples: phone = '212-855-1212'; sep ="-' ; 
parse value phone with area_code (sep) prefix (sep) number 
parse value phone with area_code 4 5 prefix 8 9 number 
parse value phone with area_code +3 +1 prefix +3 +1 number 
parse value phone with 4 sep +1 . 1 area (sep) prefix (sep) numb 


parse value phone with . (sep) prefix (sep). | — returns prefix 
parse value phone with +8 number — returns number 
parse value phone with =9 number — returns number 


Functions 


ABBREV(information, info [,length]) FORMAT(number [,[before] [,[after]]]) TRACE( [setting] ) 
ABS(number) FORMAT(number [,[before] [,[after] TRANSLATE(string [,[tableout] 
Llexpp] — [,expt]]]]) [,[tablein] [,pad]]]) 
ADDRESS() 
FUZZ() TRUNC(number [,length] ) 
ARG( [argnum [,option]] ) ; . 
INSERT(string, target [,[position] VALUE(symbol [,[newvalue] [,pool]]) 
BITAND(string1 [,[string2] [,pad]]) [length] [,pad]]) 
VERIFY (string, reference [,[option] 
BITOR(string1 [,[string2] [,pad]]) LASTPOS(needle, haystack [,start]) [,start]]) 
BITXOR(string1 [,[string2] [,pad]]) LEFT(string, length [,pad]) WORD(string, wordno) 
B2X(binary_string) LENGTH(string) WORDINDEX(string, wordno) 
CENTER(string, length [,pad]) LINEIN([name] [,[line] [,count]]) WORDLENGTH(string, wordno) 
--Or-- 
CENTRE(string, length [,pad]) LINEOUT([name] [,[string] [,line]]) WORDPOS(phrase, string [,start]) 
CHANGESTR(needle, haystack, LINES( [name] [,option] ) WORDS(string) 
newneedle) 
MAX(number1 [,number2]...) XRANGE([start] [,end]) 
CHARIN([name] [,[start] [,length]]) 
MIN(number1 [,number2]...) X2B(hexstring) 
CHAROUT([name] [,[string] [,start]]) 
OVERLAY (string1, string2 [,[start] X2C(hexstring) 
CHARS( [name] [,option] ) [,[length] [,pad]]]) 
X2D(hexstring [,length]) 
COMPARE(string1, string2 [,pad]) POS(needle, haystack [,start]) 
CONDITION( [option] ) QUALIFY( [streamid] ) 
COPIES(string, times) QUEUED() Options for Functions 
k RANDOM(max Date Time Datatype 
eno tee ncanayeen) B Base C Civil A Alphanumeric 
2D(stri lenath REVERSE(strin D Days E Elapsed B Binary 
een ct sent \ 9) E European H Hours L Lowercase 
2X(stri RIGHT(string, length [,pad] M Month L Long M Mixed case 
sensing) ( : 2 N Normal M Minutes N Number 
DATATYPE(stri t SIGN(number O Ordered N Normal S Symbol 
(string [,type}) S Standard R Reset U Uppercase 
; j U USA S Seconds W Whole # 
DATE( [option_out SOURCELINE( [line_number] ) 
[date [,option_inj]] ) W Weekly X Hex 
SPACE(string [, [length] [,pad]]) 
DELSTR(string, start [,length]) : ; 
STREAM(name [option [,command]]) Special Variables 
DELWORD(string, start [,length]) 
STRIP(string [,option] [,char]]) 
DIGITS() ; RC Return code from a command, 
SUBSTR(string, start [,[length] [,pad]]) or a SYNTAX error code 


D2C(integer [,length]) 
SUBWORD(string, start [,length]) SIGL Line number of last instruction 


D2X(integer [,length]) that caused a jump to a label 
SYMBOL(name) 


ERRORTEXT(error_no) : ae RESULT Set byaRETURN 
TIME( [option_out [,time [,option_in]] ] ) instruction in a subroutine 


FORM() 


